cli-width

cli-width

Get stdout window width, with four fallbacks, tty, output.columns, a custom environment variable and then a default.

Usage

npm install --save cli-width

'use strict';

var cliWidth = require('cli-width');

cliWidth(); // maybe 204 :)

You can also set the CLI_WIDTH environment variable.

If none of the methods are supported, and the environment variable isn't set, the default width value is going to be 0, that can be changed using the configurable options.

API

cliWidth([options])

cliWidth can be configured using an options parameter, the possible properties are:

• defaultWidth<number> Defines a default value to be used if none of the methods are available, defaults to 0
• output<object> A stream to be used to read width values from, defaults to process.stdout
• tty<object> TTY module to try to read width from as a fallback, defaults to require('tty')

Examples

Defining both a default width value and a stream output to try to read from:

var cliWidth = require('cli-width');
var ttys = require('ttys');

cliWidth({
  defaultWidth: 80,
  output: ttys.output
});

Defines a different tty module to read width from:

var cliWidth = require('cli-width');
var ttys = require('ttys');

cliWidth({
  tty: ttys
});

Tests

npm install
npm test

Coverage can be generated with npm run coverage.

Changelog

2.2.1 (2020-04-14)

Bug Fixes

• add more node versions to travis (f7bc148)
• Reduce nesting in index.js and add package-lock.json (#14) (92d8d6b)
• update deprecated deps and change coverage script (db06065)

<a name="2.2.0"></a>

Similar packages

Other packages similar to cli-width

window-size

The window-size package is similar to cli-width in that it provides the dimensions of the terminal window. However, window-size offers both width and height properties, and it can also provide dimensions based on environment variables or stdout/stderr dimensions.

term-size

Term-size is another package that offers similar functionality to cli-width. It provides the size of the terminal as an object with 'columns' and 'rows'. Unlike cli-width, term-size uses a native addon to retrieve terminal dimensions, which may offer more accurate results in some environments.